home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / times.0 < prev    next >
Text File  |  1996-09-02  |  3KB  |  65 lines
  1.  
  2. TIMES(3)                   UNIX Programmer's Manual                   TIMES(3)
  3.  
  4. NNAAMMEE
  5.      ttiimmeess - process times
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssyyss//ttiimmeess..hh>>
  9.  
  10.      _c_l_o_c_k___t
  11.      ttiimmeess(_s_t_r_u_c_t _t_m_s _*_t_p)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      TThhiiss iinntteerrffaaccee iiss oobbssoolleetteedd bbyy ggeettrruussaaggee((22)) aanndd ggeettttiimmeeooffddaayy((33))..
  15.  
  16.      The ttiimmeess() function returns the value of time in CLK_TCK's of a second
  17.      since 0 hours, 0 minutes, 0 seconds, January 1, 1970, Coordinated Univer-
  18.      sal Time.
  19.  
  20.      It also fills in the structure pointed to by _t_p with time-accounting in-
  21.      formation.
  22.  
  23.      The _t_m_s structure is defined as follows:
  24.  
  25.            typedef struct {
  26.                    clock_t tms_utime;
  27.                    clock_t tms_stime;
  28.                    clock_t tms_cutime;
  29.                    clock_t tms_cstime;
  30.            }
  31.  
  32.      The elements of this structure are defined as follows:
  33.  
  34.      _t_m_s___u_t_i_m_e   The CPU time charged for the execution of user instructions.
  35.  
  36.      _t_m_s___s_t_i_m_e   The CPU time charged for execution by the system on behalf of
  37.                  the process.
  38.  
  39.      _t_m_s___c_u_t_i_m_e  The sum of the _t_m_s___u_t_i_m_e _s and _t_m_s___c_u_t_i_m_e _s of the child pro-
  40.                  cesses.
  41.  
  42.      _t_m_s___c_s_t_i_m_e  The sum of the _t_m_s___s_t_i_m_es and _t_m_s___c_s_t_i_m_es of the child pro-
  43.                  cesses.
  44.  
  45.      All times are in CLK_TCK's of a second.
  46.  
  47.      The times of a terminated child process are included in the _t_m_s___c_u_t_i_m_e
  48.      and _t_m_s___c_s_t_i_m_e elements of the parent when one of the wait(2) functions
  49.      returns the process ID of the terminated child to the parent.  If an er-
  50.      ror occurs, ttiimmeess() returns the value ((clock_t)-1), and sets _e_r_r_n_o to
  51.      indicate the error.
  52.  
  53. EERRRROORRSS
  54.      The ttiimmeess() function may fail and set the global variable _e_r_r_n_o for any
  55.      of the errors specified for the library routines getrusage(2) and
  56.      gettimeofday(2).
  57.  
  58. SSEEEE AALLSSOO
  59.      time(1),  getrusage(2),  gettimeofday(2),  wait(2)
  60.  
  61. SSTTAANNDDAARRDDSS
  62.      The ttiimmeess() function conforms to IEEE Std1003.1-1988 (``POSIX'').
  63.  
  64. 4th Berkeley Distribution        June 4, 1993                                1
  65.